home *** CD-ROM | disk | FTP | other *** search
/ SGI Networker 4.2.9 / Networker 4.2.9 for IRIX 6.2, 6.3 and 6.4.img / dist / networker4.idb / usr / share / catman / a_man / cat1m / savegrp.z.z / savegrp.z / savegrp
Text File  |  1997-07-08  |  77KB  |  1,057 lines

  1.  
  2.  
  3.  
  4. SSSSAAAAVVVVEEEEGGGGRRRRPPPP((((1111MMMM))))                                                        SSSSAAAAVVVVEEEEGGGGRRRRPPPP((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      savegrp - start a group of NetWorker clients saving their filesystems
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ssssaaaavvvveeeeggggrrrrpppp [ _o_p_t_i_o_n_s ] [ ----RRRR | ----GGGG ] [ ggggrrrroooouuuuppppnnnnaaaammmmeeee ]
  13.  
  14.      _o_p_t_i_o_n_s:  [ ----EEEEIIIIOOOOmmmmnnnnppppvvvv ] [ ----llll _l_e_v_e_l | ----CCCC _s_c_h_e_d_u_l_e ] [ ----eeee _e_x_p_i_r_a_t_i_o_n ] [ ----tttt
  15.                _d_a_t_e ] [ ----rrrr _r_e_t_r_i_e_s ] [ ----PPPP _p_r_i_n_t_e_r ] [ ----WWWW _w_i_d_t_h ] [ ----cccc _c_l_i_e_n_t [
  16.                ----cccc _c_l_i_e_n_t ... ] ]
  17.  
  18.      aaaassssaaaavvvveeeeggggrrrrpppp   [ ----aaaa _a_u_t_h ] [ ----vvvvRRRR ] [ ----TTTT _h_a_n_g_s_e_c_o_n_d_s ] [ ----cccc _c_l_i_e_n_t ] [ -------- ...
  19.                 ]
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      The ssssaaaavvvveeeeggggrrrrpppp command runs a group of NetWorker clients through the process
  23.      of saving their filesystems (using ssssaaaavvvveeee(1M)).  The group of clients is
  24.      selected by naming a NetWorker group (see nnnnssssrrrr____ggggrrrroooouuuupppp(4)), from which
  25.      individual clients can be selected by using one or more ----cccc options.  If
  26.      no group name is specified, the NetWorker group DDDDeeeeffffaaaauuuulllltttt is used.  If a
  27.      NetWorker group is named, clients whose nnnnssssrrrr____cccclllliiiieeeennnntttt(4) resources specify
  28.      the named group in their _g_r_o_u_p attribute will be saved.  If an explicit
  29.      client list is also specified, ssssaaaavvvveeeeggggrrrrpppp will only back up those clients,
  30.      with respect to the named group.  The ssssaaaavvvveeeeggggrrrrpppp command will automatically
  31.      make a clone of the newly saved data when the appropriate attributes are
  32.      set on the NNNNSSSSRRRR ggggrrrroooouuuupppp resource (see below).
  33.  
  34.      The ssssaaaavvvveeeeggggrrrrpppp command is normally run automatically by nnnnssssrrrrdddd(1M), as
  35.      specified by each group's nnnnssssrrrr____ggggrrrroooouuuupppp(4) resource.
  36.  
  37.      The ssssaaaavvvveeeeggggrrrrpppp command will set up an RPC connection to nnnnssssrrrreeeexxxxeeeeccccdddd(1M) to run
  38.      ssssaaaavvvveeee(1M) on each client (and will fall back on using the rrrrccccmmmmdddd(3) protocol
  39.      and the client-side rrrrsssshhhhdddd(1M) if nnnnssssrrrreeeexxxxeeeeccccdddd is unavailable on the client)
  40.      for each filesystem listed in the nnnnssssrrrr____cccclllliiiieeeennnntttt(4) resource _s_a_v_e _s_e_t
  41.      attribute.  If a save set of _A_l_l is specified for a client, ssssaaaavvvveeeeggggrrrrpppp will
  42.      request from the client a list of filesystems to be saved (this is called
  43.      the _p_r_o_b_e operation).  The probe expands _A_l_l into a list by looking for
  44.      filesystems that are both local and automatically mounted on that client
  45.      machine (e.g. NFS mount points and filesystems mounted manually are
  46.      generally ignored).  The exact determination of which filesystems to save
  47.      will vary between different operating systems. See ssssaaaavvvveeeeffffssss(1M) for
  48.      additional details on the probe operation.  To see which filesystems a
  49.      client will save run a savegrp preview, _s_a_v_e_g_r_p -_c _c_l_i_e_n_t -_p (assuming
  50.      the client is in the Default group).  Each filesystem saved is called a
  51.      _s_a_v_e _s_e_t.
  52.  
  53.      The ssssaaaavvvveeeeggggrrrrpppp command attempts to keep multiple clients busy by
  54.      individually scheduling the client save sets.  As save sets complete, the
  55.      output is collected and another save set will be started by ssssaaaavvvveeeeggggrrrrpppp.
  56.  
  57.      The ppppaaaarrrraaaalllllllleeeelllliiiissssmmmm attribute in the nnnnssssrrrr____sssseeeerrrrvvvviiiicccceeee(4) resource is the maximum
  58.      number of save sets to run simultaneously.  Modifications to this
  59.      parameter will take effect as save sets complete - if the value is
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSAAAAVVVVEEEEGGGGRRRRPPPP((((1111MMMM))))                                                        SSSSAAAAVVVVEEEEGGGGRRRRPPPP((((1111MMMM))))
  71.  
  72.  
  73.  
  74.      reduced, no new save set will be started until the number of active save
  75.      sets running drops below the new value.
  76.  
  77.      When all of the save sets are completed on a client, the client's index
  78.      on the NetWorker server will be saved.  If the NetWorker server is one of
  79.      the machines being saved, its index will be saved after all the other
  80.      clients are completely done.  When the server's index is saved, the
  81.      bootstrap save set information will be printed to the default printer (or
  82.      another specified printer).  If ssssaaaavvvveeeeggggrrrrpppp detects that the NetWorker server
  83.      is not listed in any active group (a group with its autostart attribute
  84.      set), then the server's index and bootstrap will be saved with every
  85.      group.
  86.  
  87.      The ssssaaaavvvveeeeggggrrrrpppp command will detect other active invocations of the same
  88.      group, and will exit with an error message.  If two different NetWorker
  89.      groups are running simultaneously, they each will run up to _p_a_r_a_l_l_e_l_i_s_m
  90.      save sessions simultaneously, however, the NetWorker server will only
  91.      allow _p_a_r_a_l_l_e_l_i_s_m of these sessions to write to the backup devices at a
  92.      time.  Note that running multiple ssssaaaavvvveeeeggggrrrrpppp commands simultaneously can use
  93.      up significant server resources, due to the number of pending saves.
  94.  
  95.      The progress of the actively saving clients can be monitored using the
  96.      X11 based nnnnwwwwaaaaddddmmmmiiiinnnn(1M) program or the ccccuuuurrrrsssseeeessss(3X) based nnnnssssrrrrwwwwaaaattttcccchhhh(1M)
  97.      program.  The nnnnssssrrrraaaaddddmmmmiiiinnnn(1M) browser may also be used to examine the
  98.      _c_o_m_p_l_e_t_i_o_n status and _w_o_r_k _l_i_s_t of each _N_S_R _g_r_o_u_p resource, although the
  99.      _h_i_d_d_e_n attribute display option will need to be selected (see
  100.      nnnnssssrrrraaaaddddmmmmiiiinnnn(1M)).  These two attributes allows you to track the progress of
  101.      each savegrp.  See nnnnssssrrrr____ggggrrrroooouuuupppp(4) for more details.
  102.  
  103.      When ssssaaaavvvveeeeggggrrrrpppp starts, it sends an NNNNSSSSRRRR nnnnoooottttiiiiffffiiiiccccaaaattttiiiioooonnnn (see
  104.      nnnnssssrrrr____nnnnoooottttiiiiffffiiiiccccaaaattttiiiioooonnnn(4)) with an event of ssssaaaavvvveeeeggggrrrrpppp and priority of iiiinnnnffffoooo to the
  105.      NSR notification system.  This event is normally logged in the _m_e_s_s_a_g_e_s
  106.      attribute of the nnnnssssrrrr____sssseeeerrrrvvvviiiicccceeee(4) resource, and also logged in the log file
  107.      specified in the _L_o_g _d_e_f_a_u_l_t NSR notification resource.
  108.  
  109.      When all the save sets have finished, the save sets are automatically
  110.      cloned, if the NNNNSSSSRRRR ggggrrrroooouuuupppp resource has the cccclllloooonnnneeeessss attribute enabled.
  111.      Clones will be sent to the the pool named in the cccclllloooonnnneeee ppppoooooooollll attribute.
  112.      Changing the values of these attributes while ssssaaaavvvveeeeggggrrrrpppp is running has no
  113.      effect; they must be set before ssssaaaavvvveeeeggggrrrrpppp starts.  The nnnnssssrrrrcccclllloooonnnneeee(1M) command
  114.      is used to clone the save sets.  Since ssssaaaavvvveeeeggggrrrrpppp uses a heuristic to
  115.      determine which save sets were generated as part of the group, it may
  116.      occasionally clone more save sets than expected, if a client has its
  117.      filesystems separated into multiple groups that run at the same time.
  118.      Note that at least two active devices are required to clone save sets.
  119.  
  120.      When the save sets are all complete and cloned (if cloning is enabled),
  121.      an NNNNSSSSRRRR nnnnoooottttiiiiffffiiiiccccaaaattttiiiioooonnnn with an event of ssssaaaavvvveeeeggggrrrrpppp and priority of nnnnoooottttiiiicccceeee is
  122.      sent to the NSR notification system.  This is generally set up to cause
  123.      e-mail to be sent to the rrrrooooooootttt user specifying the list of clients who
  124.      failed (if any), and all the output collected from all clients.  The
  125.      format and common error messages included in the savegrp notification are
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. SSSSAAAAVVVVEEEEGGGGRRRRPPPP((((1111MMMM))))                                                        SSSSAAAAVVVVEEEEGGGGRRRRPPPP((((1111MMMM))))
  137.  
  138.  
  139.  
  140.      explained in the SSSSAAAAVVVVEEEEGGGGRRRRPPPP CCCCOOOOMMMMPPPPLLLLEEEETTTTIIIIOOOONNNN NNNNOOOOTTTTIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN MMMMEEEESSSSSSSSAAAAGGGGEEEE section, below.
  141.  
  142.      The aaaassssaaaavvvveeeeggggrrrrpppp command is run only by ssssaaaavvvveeeeggggrrrrpppp, and monitors the progress of
  143.      individual save sets.  The command line options show which save set and
  144.      client is being monitored, and can be viewed using the ppppssss(1) command.
  145.      The ----aaaa option shows the authentication type being used, ----TTTT shows the time
  146.      before an inactive save set is considered hung, and ----cccc shows the client
  147.      being monitored.  The ----RRRR option means a filesystem probe is being
  148.      performed, and the ----vvvv option requests verbose output from aaaassssaaaavvvveeeeggggrrrrpppp....
  149.      Additional information, such as the name of the save set being saved, is
  150.      shown after the -------- (double dash) option.
  151.  
  152. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  153.      ----EEEE   Cause ssssaaaavvvveeee(1M) on each client to estimate the amount of data which
  154.           will be generated by each save set before performing it.  This will
  155.           result in the filesystem trees being walked twice - once to generate
  156.           a estimate of how much data would be generated, and again to
  157.           generate a save stream to the NetWorker server.  Note that the data
  158.           is only read from the disk on the final filesystem walk, as the
  159.           estimate is performed by using inode information.
  160.  
  161.      ----IIII   Disable the saving of each client's index.
  162.  
  163.      ----OOOO   Only save each client's index (for the server, the bootstrap is also
  164.           saved).
  165.  
  166.      ----mmmm   Disable monitor status reporting, including all NNNNSSSSRRRR nnnnoooottttiiiiffffiiiiccccaaaattttiiiioooonnnn
  167.           actions.
  168.  
  169.      ----nnnn   No save.  Cause ssssaaaavvvveeee to perform an estimate as described for ----EEEE, but
  170.           not to perform any actual saves.  This option also sets ----mmmm....
  171.  
  172.      ----pppp   Run the probe step on each client, so you can see which filesystem
  173.           would be saved and at what level, but do not actually save any data.
  174.           This option also sets ----mmmm....  The output generated by the ----pppp option may
  175.           show several save levels for each save set at different points in
  176.           the output, as ssssaaaavvvveeeeggggrrrrpppp learns the correct level.  This is the
  177.           expected behavior, and can be useful for debugging.  The actual
  178.           level the savegrp will use will be shown the last time each save set
  179.           is shown in the output.
  180.  
  181.      ----vvvv   Verbose.  Print extra information about what ssssaaaavvvveeeeggggrrrrpppp is doing, and
  182.           do not pass the ----qqqq flag along to ssssaaaavvvveeee so it too will be chatty.
  183.  
  184.      ----GGGG   Just run the group; apply no restart semantics.  This is the default
  185.           mode of operation; the option is provided for compatibility with
  186.           other versions of ssssaaaavvvveeeeggggrrrrpppp.
  187.  
  188.      ----RRRR   Restart.  Use the information stored with the NetWorker server to
  189.           restart a group which previously was terminated, generally due to a
  190.           crash of the NetWorker server machine.
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. SSSSAAAAVVVVEEEEGGGGRRRRPPPP((((1111MMMM))))                                                        SSSSAAAAVVVVEEEEGGGGRRRRPPPP((((1111MMMM))))
  203.  
  204.  
  205.  
  206.      ----llll _l_e_v_e_l
  207.           The level of save (see nnnnssssrrrr____sssscccchhhheeeedddduuuulllleeee(4)) to perform on each client.
  208.           This overrides the save level which ssssaaaavvvveeeeggggrrrrpppp would normally
  209.           automaticly determine.  ----llll and ----CCCC cannot be specified together.
  210.  
  211.      ----CCCC _s_c_h_e_d_u_l_e
  212.           The name of the NNNNSSSSRRRR sssscccchhhheeeedddduuuulllleeee (see nnnnssssrrrr____sssscccchhhheeeedddduuuulllleeee(4)) to be used in the
  213.           automatic save level selection process which ssssaaaavvvveeeeggggrrrrpppp normally
  214.           performs.  This overrides the save schedule which ssssaaaavvvveeeeggggrrrrpppp would
  215.           normally use for a given client.  ----llll and ----CCCC cannot be specified
  216.           together.
  217.  
  218.      ----eeee _e_x_p_i_r_a_t_i_o_n
  219.           Set the date (in nnnnssssrrrr____ggggeeeettttddddaaaatttteeee(3) format) when the saved data will
  220.           expire.  The special value ffffoooorrrreeeevvvveeeerrrr is used to indicate that a volume
  221.           that never expires (i.e. an archive or a migration volume) must be
  222.           used.  By default, no explicit expiration date is used.
  223.  
  224.      ----tttt _d_a_t_e
  225.           The time to use instead of the current time for determining which
  226.           level to use for this savegrp (in nnnnssssrrrr____ggggeeeettttddddaaaatttteeee(3) format).  By
  227.           default, the current time is used.
  228.  
  229.      ----rrrr _r_e_t_r_i_e_s
  230.           The number of times failed clients should be retried before ssssaaaavvvveeeeggggrrrrpppp
  231.           gives up and declares them failed.  The default is taken from the
  232.           group resource.  Abandoned saves are not retried, because they may
  233.           eventually complete.  Retries are not attempted if ----pppp is specified.
  234.  
  235.      ----PPPP _p_r_i_n_t_e_r
  236.           The printer which ssssaaaavvvveeeeggggrrrrpppp should use for printing bootstrap
  237.           information.
  238.  
  239.      ----WWWW _w_i_d_t_h
  240.           The width used when formatting output or notification messages.  By
  241.           default, this is 80.
  242.  
  243.      _g_r_o_u_p
  244.           Specifies the NetWorker group of clients that should be started,
  245.           rather than the default NSR group (which has the nnnnaaaammmmeeee attribute of
  246.           ddddeeeeffffaaaauuuulllltttt).  See nnnnssssrrrr____ggggrrrroooouuuupppp(4) for more details.
  247.  
  248.      ----cccc _c_l_i_e_n_t
  249.           The name of a client on which to save filesystems.  There can be
  250.           multiple ----cccc _c_l_i_e_n_t specifications.  When ----cccc options are specified,
  251.           only the named clients from the specified group (which is "Default"
  252.           if no group is specified) will be run.
  253.  
  254. RRRREEEESSSSOOOOUUUURRRRCCCCEEEE TTTTYYYYPPPPEEEESSSS
  255.      NNNNSSSSRRRR          Use the ppppaaaarrrraaaalllllllleeeelllliiiissssmmmm attribute for the maximum number of
  256.                   saves to start simultaneously.
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. SSSSAAAAVVVVEEEEGGGGRRRRPPPP((((1111MMMM))))                                                        SSSSAAAAVVVVEEEEGGGGRRRRPPPP((((1111MMMM))))
  269.  
  270.  
  271.  
  272.      NNNNSSSSRRRR ggggrrrroooouuuupppp    The attribute _w_o_r_k _l_i_s_t contains values in groups of 3,
  273.                   specifying the client name, level of save, and path to save,
  274.                   for each save set not yet completed.  The attribute
  275.                   _c_o_m_p_l_e_t_i_o_n contains values in groups of 4, specifying the
  276.                   client name, path saved, status, and the output, for each
  277.                   save set completed.
  278.      NNNNSSSSRRRR sssscccchhhheeeedddduuuulllleeee Used by the ssssaaaavvvveeeeggggrrrrpppp command with each client's nnnnssssrrrr____cccclllliiiieeeennnntttt(4)
  279.                   resource to determine which level of save to perform for
  280.                   each specified save set.
  281.      NNNNSSSSRRRR cccclllliiiieeeennnntttt   Each client resource names the groups it should be saved by,
  282.                   the names of the save sets which should be saved, the name
  283.                   of the schedule to use (see nnnnssssrrrr____sssscccchhhheeeedddduuuulllleeee(4)).  and the name
  284.                   of the directives to use (see nnnnssssrrrr____ddddiiiirrrreeeeccccttttiiiivvvveeee(4)).
  285.      NNNNSSSSRRRR nnnnoooottttiiiiffffiiiiccccaaaattttiiiioooonnnn
  286.                   Three kinds of notices are sent to the NSR notification
  287.                   system, both with the eeeevvvveeeennnntttt attribute of _s_a_v_e_g_r_p.  While a
  288.                   savegrp is in progress, status notices are sent with the
  289.                   pppprrrriiiioooorrrriiiittttyyyy of _i_n_f_o.  At completion of a savegrp, a notice is
  290.                   sent containing the collected output of all saves, and the
  291.                   name of clients which had a save which failed (if any).
  292.                   This notice will have an eeeevvvveeeennnntttt type of _s_a_v_e_g_r_p, and a
  293.                   pppprrrriiiioooorrrriiiittttyyyy of _n_o_t_i_c_e.  If ssssaaaavvvveeeeggggrrrrpppp is interrupted, a notice
  294.                   stating the group was terminated, with an eeeevvvveeeennnntttt type of
  295.                   _s_a_v_e_g_r_p, and a pppprrrriiiioooorrrriiiittttyyyy of _a_l_e_r_t will be sent.  These last
  296.                   two typically will result in the notice being encapsulated
  297.                   in a mail message to rrrrooooooootttt.
  298.  
  299. SSSSAAAAVVVVEEEEGGGGRRRROOOOUUUUPPPP CCCCOOOOMMMMPPPPLLLLEEEETTTTIIIIOOOONNNN NNNNOOOOTTTTIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN MMMMEEEESSSSSSSSAAAAGGGGEEEE
  300.      The savegroup completion notification message contains 5 parts: the
  301.      header, the Never Started Save Sets, the Unsuccessful Save Sets, the
  302.      Successful Save Sets, and the Cloned Save Sets.  Each client in the group
  303.      will be listed in one or more of sections categories (more than one if
  304.      some save sets are in one category, and other save sets in another
  305.      category).  The clients are listed in alphanumeric sorted order, with the
  306.      server listed last.
  307.  
  308.      The header shows the name of the group and lists which clients failed.
  309.      If the group was aborted, the header includes an indicator of this as
  310.      well.  The header also shows the time the group was started (or
  311.      restarted, if the ----RRRR option was used), and the time the savegrp
  312.      completed.  The failed clients list in the header shows only those
  313.      clients for which saves were attempted, not those for which saves never
  314.      started.
  315.  
  316.      The Never Started Save Sets section is optional and will only be included
  317.      if there are some save sets of some clients in the group that were never
  318.      started.  This should only occur when a savegrp is aborted, either by
  319.      killing the master savegrp daemon or by selecting the _S_t_o_p function in
  320.      the _G_r_o_u_p _C_o_n_t_r_o_l window or the _S_t_o_p _N_o_w attribute in the _G_r_o_u_p window of
  321.      nnnnwwwwaaaaddddmmmmiiiinnnn(1M).  Each entry listed in this section shows the client and save
  322.      set that was never started (or _A_l_l if no save sets were saved for that
  323.      client).  No other error messages should appear in this section.
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. SSSSAAAAVVVVEEEEGGGGRRRRPPPP((((1111MMMM))))                                                        SSSSAAAAVVVVEEEEGGGGRRRRPPPP((((1111MMMM))))
  335.  
  336.  
  337.  
  338.      The Unsuccessful Save Sets section shows all of the saves that were
  339.      attempted but failed.  This section will only be present if at least one
  340.      save set failed.  There are many reasons for a save to fail.  The most
  341.      common are listed below.  More reasons will be listed in the future.  It
  342.      is important to differentiate between the many reasons for a save to
  343.      fail, so that the administrator can quickly determine the cause and fix
  344.      it, so the save will succeed the next time.
  345.  
  346.      Each entry in the Unsuccessful Save Sets section lists the client and
  347.      save set that failed, along with one or more lines of error and
  348.      information messages.  Each client is separated by a blank line, and all
  349.      the failed save sets for a client a listed together.  Typical error or
  350.      information messages are listed at the end of this section, (without the
  351.      client:saveset prefix), with the necessary action(s) to take to correct
  352.      the problem.
  353.  
  354.      Each entry in the Successful Save Sets section lists the client and save
  355.      set that succeeded, along with level of the save, the amount of data
  356.      saved, the time to run the save set, and the number of files saved.  Each
  357.      entry may also be preceded by one or more warning or informational
  358.      messages, the most common of which are listed below.  These warning or
  359.      informational messages are usually (but not always) prefixed by ``* ''.
  360.      Note that a save set's output may include warnings; these do not
  361.      necessarily mean the save set was unsuccessful.  See ssssaaaavvvveeee(1M) for the
  362.      definitions a successful and unsuccessful save sets.
  363.  
  364.      The Cloned Save Sets section is somewhat different, because it refers to
  365.      the save sets cloned, and not the clients that originated those save
  366.      sets.  The output shown in this section is the output of the nnnnssssrrrrcccclllloooonnnneeee
  367.      command.  See the nnnnssssrrrrcccclllloooonnnneeee(1M) man page for information on the output of
  368.      nnnnssssrrrrcccclllloooonnnneeee.
  369.  
  370.      The following is a list of common informational, warning and error
  371.      messages found in the completion notification.  This list is not
  372.      complete.  Note that the messages you see may vary slightly from those
  373.      shown here due to differences in the operating system vendor-supplied
  374.      error messages.  Since many messages include client or server names, it
  375.      is most efficient to look for a keyword in the error message.  The
  376.      messages are listed below in alphabetical order, by the first non-
  377.      variable word in the message (note: initial words like "save", "asm" and
  378.      "savefs" may or may not vary, and initial pathnames are always assumed to
  379.      vary).
  380.  
  381.      aaaabbbboooorrrrtttteeeedddd
  382.           This informational message only occurs when you abort a running
  383.           savegrp, generally by selecting _S_t_o_p from the Group Control Window
  384.           of the nnnnwwwwaaaaddddmmmmiiiinnnn(1M) interface.  It means that the specified save set
  385.           had started saving, but had not completed when the savegrp was
  386.           aborted.  The session (in the Sessions display of nnnnwwwwaaaaddddmmmmiiiinnnn(1M)) for
  387.           this save set may not disappear immediately, especially if ssssaaaavvvveeeeggggrrrrpppp's
  388.           attempt to kill the save session fails.  The save set will be
  389.           retried if and when you _R_e_s_t_a_r_t the savegrp (e.g. from the Group
  390.  
  391.  
  392.  
  393.                                                                         PPPPaaaaggggeeee 6666
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. SSSSAAAAVVVVEEEEGGGGRRRRPPPP((((1111MMMM))))                                                        SSSSAAAAVVVVEEEEGGGGRRRRPPPP((((1111MMMM))))
  401.  
  402.  
  403.  
  404.           Control Window).
  405.  
  406.      AAAAcccccccceeeessssssss vvvviiiioooollllaaaattttiiiioooonnnn ffffrrrroooommmm _c_l_i_e_n_t ---- iiiinnnnsssseeeeccccuuuurrrreeee ppppoooorrrrtttt _N
  407.           This message, generated by the ssssaaaavvvveeee command on client, means that
  408.           ssssaaaavvvveeee is not setuid root.  Make sure that the ssssaaaavvvveeee command on the
  409.           client is owned by root and has its setuid bit set.  If ssssaaaavvvveeee is on
  410.           an NFS mounted filesystem, make sure the filesystem was not mounted
  411.           on that client using the "-nosuid" option.
  412.  
  413.      AAAAcccccccceeeessssssss vvvviiiioooollllaaaattttiiiioooonnnn ---- uuuunnnnkkkknnnnoooowwwwnnnn hhhhoooosssstttt:::: _c_l_i_e_n_t
  414.           This message is caused when then the client's hostname and IP
  415.           address are not correctly listed in one or more of /etc/hosts, NIS
  416.           or DNS on the server.  You need to either change the appropriate
  417.           host table (depending on which one(s) are in use on your server) to
  418.           list the client's name as it is know to NetWorker, as that client's
  419.           primary name, or you need to add the name listed at the end of the
  420.           error message to the _a_l_i_a_s_e_s attribute of the client's Client
  421.           resource(s).
  422.  
  423.      _a_s_m:::: ccccaaaannnnnnnnooootttt ooooppppeeeennnn _p_a_t_h:::: IIII////OOOO eeeerrrrrrrroooorrrr
  424.           This message generally means that there are bad blocks on the
  425.           disk(s) containing the specified file or directory.  You should
  426.           immediately run a filesystem check on the named client filesystem
  427.           and check your client's system error log.  If there are bad block,
  428.           repair them if possible, or move the filesystem to a different disk.
  429.  
  430.      _a_s_m:::: ccccaaaannnnnnnnooootttt ssssttttaaaatttt _p_a_t_h:::: SSSSttttaaaalllleeee NNNNFFFFSSSS ffffiiiilllleeee hhhhaaaannnnddddlllleeee
  431.      _a_s_m:::: ccccaaaannnnnnnnooootttt ssssttttaaaatttt _p_a_t_h:::: MMMMiiiissssssssiiiinnnngggg ffffiiiilllleeee oooorrrr ffffiiiilllleeeessssyyyysssstttteeeemmmm
  432.           These informational messages (or variants of them for other
  433.           operating systems) mean that the when ssssaaaavvvveeee attempted to test the
  434.           named directory to determine if it was a different filesystem from
  435.           the one currently being saved, the filesystem was, in fact NFS
  436.           mounted, but the mount point was bad.  While this message does not
  437.           affect the saved data, it does mean you have a network or NFS
  438.           problem between the specified client and one or more of its
  439.           fileservers.  You may need to remount filesystems on the client, or
  440.           perhaps reboot it, to correct the problem.
  441.  
  442.      /_p_a_t_h////nnnnssssrrrreeeexxxxeeeeccccdddd:::: CCCCaaaannnn''''tttt mmmmaaaakkkkeeee ppppiiiippppeeee
  443.      /_p_a_t_h////nnnnssssrrrreeeexxxxeeeeccccdddd:::: CCCCaaaannnn''''tttt ffffoooorrrrkkkk
  444.      ffffoooorrrrkkkk:::: NNNNoooo mmmmoooorrrreeee pppprrrroooocccceeeesssssssseeeessss
  445.           The specified client-side resource has been exceeded.  There are too
  446.           many other services running on the client while savegrp is running.
  447.           Inspect the client and determine why it has run out of resources.
  448.           The client may need to be rebooted.  You should also consider re-
  449.           scheduling any jobs automatically started on the client (e.g. via
  450.           ccccrrrroooonnnn(1M)) that run while savegrp is running.
  451.  
  452.      _a_s_m:::: cccchhhhddddiiiirrrr ffffaaaaiiiilllleeeedddd _p_a_t_h:::: PPPPeeeerrrrmmmmiiiissssssssiiiioooonnnn ddddeeeennnniiiieeeedddd
  453.           This message means that while backing up the specified save set,
  454.           ssssaaaavvvveeee was unable to enter the named directory.  This may mean that
  455.           ssssaaaavvvveeee is not setuid root on the specified client, or that the
  456.  
  457.  
  458.  
  459.                                                                         PPPPaaaaggggeeee 7777
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. SSSSAAAAVVVVEEEEGGGGRRRRPPPP((((1111MMMM))))                                                        SSSSAAAAVVVVEEEEGGGGRRRRPPPP((((1111MMMM))))
  467.  
  468.  
  469.  
  470.           directory is actually an NFS mount point for which root is not
  471.           allowed access.  Check the permissions on ssssaaaavvvveeee on the specified
  472.           client (using llllssss(1)) and make sure that ssssaaaavvvveeee is owned by root and
  473.           that the setuid bit is set.
  474.  
  475.      ccccoooonnnnnnnneeeecccctttt ttttoooo aaaaddddddddrrrreeeessssssss AAAAAAAA....BBBBBBBB....CCCCCCCC....DDDDDDDD:::: _m_e_s_s_a_g_e
  476.      TTTTrrrryyyyiiiinnnngggg AAAAAAAA....BBBBBBBB....CCCCCCCC....DDDDDDDD............
  477.           These informational messages are displayed only when the ----vvvv option
  478.           is used.  They mean that the connection to the client failed on the
  479.           address specified in the first line of the message.  If the client
  480.           has more than one IP address, savegrp has attempted the address
  481.           listed in the second line.  Looking at subsequent lines of the
  482.           completion mail show if this second address succeeded.  You may want
  483.           to check and change your network routing tables to avoid getting
  484.           these messages.
  485.  
  486.      CCCCoooonnnnnnnneeeeccccttttiiiioooonnnn rrrreeeeffffuuuusssseeeedddd
  487.           This means the client machine is up, but it is not accepting new
  488.           network connections for nnnnssssrrrreeeexxxxeeeeccccdddd (or rrrrsssshhhhdddd).  This could mean the
  489.           client was in the process of booting when the savegrp attempted to
  490.           connect, or that the client had exceeded some resource limit, and
  491.           was not accepting any new connections.  You should attempt to log
  492.           into the client and verify that it is accepting remote connections.
  493.           If the client is a non-Unix machine, you may need to start the
  494.           NetWorker client on that machine.  Refer to your ClientPak
  495.           installation for more information.
  496.  
  497.      CCCCoooonnnnnnnneeeeccccttttiiiioooonnnn ttttiiiimmmmeeeedddd oooouuuutttt
  498.           This usually means the client has crashed or is hung.  Make sure the
  499.           client has rebooted, and that nnnnssssrrrreeeexxxxeeeeccccdddd is running on it (if you are
  500.           using nnnnssssrrrreeeexxxxeeeeccccdddd).  If the client is a non-Unix machine, you may need
  501.           to ensure that the network protocols are loaded, and that the
  502.           NetWorker client is running on that machine.  Refer to your
  503.           ClientPak installation for more information.
  504.  
  505.      _a_s_m:::: eeeexxxxtttteeeerrrrnnnnaaaallll AAAASSSSMMMM ````_a_s_m_2'''' eeeexxxxiiiitttteeeedddd wwwwiiiitttthhhh ccccooooddddeeee 1111
  506.           This message generally accompanies another message reporting a
  507.           specific problem while saving a file or directory on the named save
  508.           set.  The backup will attempt to continue and attempt to save other
  509.           data, and generally, the backup will not be listed in the failed
  510.           save sets section of the completion mail if any files on the save
  511.           set are saved successfully, even if it only saves the top directory
  512.           of the save set.
  513.  
  514.      ssssaaaavvvveeee:::: _p_a_t_h ffffiiiilllleeee ssssiiiizzzzeeee cccchhhhaaaannnnggggeeeedddd!!!!
  515.           This informational message is often generated when NetWorker backs
  516.           up log files.  It may also occur for other files.  For files that
  517.           you expect to grow while ssssaaaavvvveeeeggggrrrrpppp is running, you can use a directive
  518.           specifying that the llllooooggggaaaassssmmmm(1M) should be used to back up the file.
  519.           See also nnnnssssrrrr(4) and nnnnssssrrrr____ddddiiiirrrreeeeccccttttiiiivvvveeee(4).
  520.  
  521.  
  522.  
  523.  
  524.  
  525.                                                                         PPPPaaaaggggeeee 8888
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532. SSSSAAAAVVVVEEEEGGGGRRRRPPPP((((1111MMMM))))                                                        SSSSAAAAVVVVEEEEGGGGRRRRPPPP((((1111MMMM))))
  533.  
  534.  
  535.  
  536.      _a_s_m:::: ggggeeeettttwwwwdddd ffffaaaaiiiilllleeeedddd
  537.           This message means that while backing up the specified save set, an
  538.           attempt to determine the current directory's name failed.  This
  539.           occurs on clients, generally running older versions of the NetWorker
  540.           ClientPak, on which the ggggeeeettttwwwwdddd(3) library call is broken.  You may
  541.           want to contact Legato Tech Support to find out if there is a patch
  542.           available for your client platform to work around this vendor-
  543.           specific bug, or contact your operating system vendor to see if a
  544.           more recent O.S. version addresses this problem.
  545.  
  546.      ggggrrrroooouuuupppp _g_r_o_u_p_n_a_m_e aaaabbbboooorrrrtttteeeedddd,,,, ssssaaaavvvveeeeggggrrrrpppp iiiissss aaaallllrrrreeeeaaaaddddyyyy rrrruuuunnnnnnnniiiinnnngggg
  547.           This message is only delivered by itself.  It occurs when the named
  548.           group has already been started or restarted (eg after a reboot, or
  549.           when requested via the Group Control Window of nnnnwwwwaaaaddddmmmmiiiinnnn(1M)), either
  550.           automatically by nnnnssssrrrrdddd(1M) or manually, from the command line.  You
  551.           can use ppppssss(1) to find out the process id of a running savegrp.  The
  552.           existance of a running group is determined by looking for a file
  553.           named ////nnnnssssrrrr////ttttmmmmpppp////ssssgggg...._g_r_o_u_p which, if existing and locked, means a
  554.           savegrp is running.
  555.  
  556.      hhhhaaaassss bbbbeeeeeeeennnn iiiinnnnaaaaccccttttiiiivvvveeee ffffoooorrrr _N mmmmiiiinnnnuuuutttteeeessss ssssiiiinnnncccceeee _t_i_m_e....
  557.      _c_l_i_e_n_t:_s_a_v_e_s_e_t iiiissss bbbbeeeeiiiinnnngggg aaaabbbbaaaannnnddddoooonnnneeeedddd bbbbyyyy ssssaaaavvvveeeeggggrrrrpppp....
  558.           A backup of the specified save set started, but after _N minutes of
  559.           no activity, and ssssaaaavvvveeeeggggrrrrpppp gave up on the save set.  Generally, this
  560.           means that the client is hung waiting for an NFS partition.
  561.           Unfortunately, NetWorker (or any other program) has no way of
  562.           reliably telling if an NFS partition will hang until after it tries
  563.           to access the partition.  When the partition comes back on line, the
  564.           save will complete, despite the fact that ssssaaaavvvveeeeggggrrrrpppp abandoned it.  You
  565.           should check the client, however, since you sometimes need to reboot
  566.           the client to unhang NFS partitions.  Non-Unix clients also hang for
  567.           other reasons, most notably, bugs in the operating system
  568.           implementation of their network protocols.
  569.  
  570.      HHHHoooosssstttt iiiissss uuuunnnnrrrreeeeaaaacccchhhhaaaabbbblllleeee
  571.           The NetWorker server cannot make TCP/IP connections to the client.
  572.           This generally means the network itself is not configured correctly;
  573.           most commonly, one or more gateways or routers are down, or the
  574.           network routes were not set up correctly.  You should verify that
  575.           the server can connect to the client, and if not, check and, if
  576.           necessary, reconfigure your routers, gateways or routing tables.
  577.  
  578.      LLLLooooggggiiiinnnn iiiinnnnccccoooorrrrrrrreeeecccctttt
  579.           This message is generated when the _r_e_m_o_t_e _u_s_e_r attribute for the
  580.           client is not set to a valid login on the client.  Verify that the
  581.           _r_e_m_o_t_e _u_s_e_r attribute for the client is set to the correct login
  582.           name.  You may see this message even when running nnnnssssrrrreeeexxxxeeeeccccdddd if
  583.           nnnnssssrrrreeeexxxxeeeeccccdddd has not been started (or was killed) on the client.
  584.  
  585.      _a_s_m:::: mmmmiiiissssssssiiiinnnngggg hhhhaaaarrrrdddd lllliiiinnnnkkkkssss nnnnooootttt ffffoooouuuunnnndddd::::
  586.           This message is generated when a backed-up file had one or more hard
  587.           links that were not found.  The message is followed by a list of one
  588.  
  589.  
  590.  
  591.                                                                         PPPPaaaaggggeeee 9999
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598. SSSSAAAAVVVVEEEEGGGGRRRRPPPP((((1111MMMM))))                                                        SSSSAAAAVVVVEEEEGGGGRRRRPPPP((((1111MMMM))))
  599.  
  600.  
  601.  
  602.           or more file names which were backed up minus some links.  The
  603.           message means that the files were either created (with multiple hard
  604.           links) while the backup was occurring, so some of the links were
  605.           missed due to the order of filesystem tree walking, or the file (or
  606.           some links) were removed while the backup was occurring.  Only those
  607.           links that were found can be recovered; additional links will have
  608.           been lost.  One can do an additional incremental backup of the
  609.           affected filesystem if a consistent state for the affected file is
  610.           essential.
  611.  
  612.      ssssaaaavvvveeee:::: nnnneeeettttwwwwoooorrrrkkkk eeeerrrrrrrroooorrrr,,,, sssseeeerrrrvvvveeeerrrr mmmmaaaayyyy bbbbeeee ddddoooowwwwnnnn
  613.           The backup of the named filesystem was begun, but the connection to
  614.           the NetWorker server closed part way through.  This typically means
  615.           that the server machine rebooted, or one or more save agents were
  616.           killed by the system administrator or by the system itself (e.g. due
  617.           to overwriting the binary or a disk error in swap space).  Restart
  618.           the save at a later time.
  619.  
  620.      nnnnoooo ccccyyyycccclllleeeessss ffffoooouuuunnnndddd iiiinnnn mmmmeeeeddddiiiiaaaa ddddbbbb;;;; ddddooooiiiinnnngggg ffffuuuullllllll ssssaaaavvvveeee
  621.           This informational message is added by ssssaaaavvvveeeeggggrrrrpppp to any save set that
  622.           is saved at the level _f_u_l_l instead of the level found in the
  623.           client's schedule.  Due to timing problems, you can occasionally see
  624.           this message when the clocks on the client and server are out of
  625.           sync, or when ssssaaaavvvveeeeggggrrrrpppp starts before midnight and ends after
  626.           midnight.  You may also get spurious messages of this type from some
  627.           versions of NetWorker client software backing up a NetWare BINDERY,
  628.           which ignore the schedule and perform a full, no matter what.  In
  629.           both these cases, the client re-checks the level, and overrides the
  630.           server's requested level.
  631.  
  632.      NNNNoooo mmmmoooorrrreeee pppprrrroooocccceeeesssssssseeeessss
  633.           See "Can't make pipe", above.
  634.  
  635.      NNNNoooo ''''NNNNSSSSRRRR cccclllliiiieeeennnntttt'''' rrrreeeessssoooouuuurrrrcccceeee ffffoooorrrr cccclllliiiieeeennnntttt _c_l_i_e_n_t_h_o_s_t_n_a_m_e
  636.      ssssaaaavvvveeeeffffssss:::: ccccaaaannnnnnnnooootttt rrrreeeettttrrrriiiieeeevvvveeee cccclllliiiieeeennnntttt rrrreeeessssoooouuuurrrrcccceeeessss
  637.           This pair of messages occurs if the the client's hostname changed
  638.           (in /etc/hosts, NIS or DNS).  You may also have deleted the client's
  639.           _C_l_i_e_n_t resource while savegrp was running.  In the former case, you
  640.           will need to add the client's new name to the _a_l_i_a_s_e_s attribute of
  641.           the client (this is a hidden attribute) using nnnnssssrrrraaaaddddmmmmiiiinnnn(1M)
  642.           (selecting the _H_i_d_d_e_n display option) or nnnnwwwwaaaaddddmmmmiiiinnnn(1M) (selecting the
  643.           _D_e_t_a_i_l_s _V_i_e_w option for the _C_l_i_e_n_t window).  In the latter case, no
  644.           additional action is required if this deletion was intentional (the
  645.           next run of ssssaaaavvvveeeeggggrrrrpppp will not attempt to save the client).  If it was
  646.           accidental, and you did not want to delete the client, you should
  647.           add the client back again and add the client back into the
  648.           appropriate group(s).  The next time ssssaaaavvvveeeeggggrrrrpppp runs, it will back up
  649.           the client, just as if the client had been down the previous day.
  650.  
  651.      nnnnoooo oooouuuuttttppppuuuutttt
  652.           The save set completed, but returned no status output.  The most
  653.           common reasons are that the client crashed or lost its network
  654.  
  655.  
  656.  
  657.                                                                        PPPPaaaaggggeeee 11110000
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664. SSSSAAAAVVVVEEEEGGGGRRRRPPPP((((1111MMMM))))                                                        SSSSAAAAVVVVEEEEGGGGRRRRPPPP((((1111MMMM))))
  665.  
  666.  
  667.  
  668.           connection (i.e.. a router between the client and server crashed)
  669.           while the client was being backed up.  Another is that the disk on
  670.           which the client status was being logged filled up (perform a ddddffff
  671.           ////nnnnssssrrrr////ttttmmmmpppp to see if this was the case).  To determine if the save set
  672.           was saved, you can use mmmmmmmmiiiinnnnffffoooo(1M).  For example, run mmmmmmmmiiiinnnnffffoooo ----vvvv ----cccc
  673.           _c_l_i_e_n_t_n_a_m_e ----tttt ''''1111 ddddaaaayyyy aaaaggggoooo'''' and look at the _f_l_a_g_s column for the
  674.           completion status.  An 'a' flag means it aborted.  Use a more
  675.           distant time (the ----tttt option) to look further back in time.
  676.  
  677.      _f_i_l_e_s_y_s_t_e_m:::: NNNNoooo ssssuuuucccchhhh ffffiiiilllleeee oooorrrr ddddiiiirrrreeeeccccttttoooorrrryyyy
  678.           An explicit save set was named in the _C_l_i_e_n_t resource for the
  679.           specified client, and that save set does not exist (or is not
  680.           currently mounted) on the client.  Make sure you spelled the save
  681.           set name correctly (and that it is capitalized correctly), and log
  682.           into the client and verify that the save set is mounted.
  683.  
  684.      /_p_a_t_h////nnnnssssrrrreeeexxxxeeeeccccdddd:::: CCCCoooouuuullllddddnnnn''''tttt llllooooooookkkk uuuupppp aaaaddddddddrrrreeeessssssss ffffoooorrrr yyyyoooouuuurrrr hhhhoooosssstttt
  685.      /_p_a_t_h////nnnnssssrrrreeeexxxxeeeeccccdddd:::: HHHHoooosssstttt aaaaddddddddrrrreeeessssssss mmmmiiiissssmmmmaaaattttcccchhhh ffffoooorrrr _s_e_r_v_e_r
  686.           The nnnnssssrrrreeeexxxxeeeeccccdddd daemon on the client managed to look up the server in
  687.           the client's host table, but the address listed there did not match
  688.           the address of the server.  Every interface of the server must have
  689.           a unique name listed in the host table (possibly with non-unique
  690.           aliases or CNAME's), and each unique name must be listed as a valid
  691.           server to nnnnssssrrrreeeexxxxeeeeccccdddd.
  692.  
  693.      /_p_a_t_h////nnnnssssrrrreeeexxxxeeeeccccdddd:::: HHHHoooosssstttt _s_e_r_v_e_r ccccaaaannnnnnnnooootttt rrrreeeeqqqquuuueeeesssstttt ccccoooommmmmmmmaaaannnndddd eeeexxxxeeeeccccuuuuttttiiiioooonnnn
  694.      /_p_a_t_h////nnnnssssrrrreeeexxxxeeeeccccdddd:::: YYYYoooouuuurrrr hhhhoooosssstttt ccccaaaannnnnnnnooootttt rrrreeeeqqqquuuueeeesssstttt ccccoooommmmmmmmaaaannnndddd eeeexxxxeeeeccccuuuuttttiiiioooonnnn
  695.           The server is not listed in nnnnssssrrrreeeexxxxeeeeccccdddd's list of valid servers on the
  696.           specified client.  The list of valid servers is either on the
  697.           nnnnssssrrrreeeexxxxeeeeccccdddd command line (with one or more ----ssss _s_e_r_v_e_r options to
  698.           nnnnssssrrrreeeexxxxeeeeccccdddd), or in a file (with the ----ffff _f_i_l_e option to nnnnssssrrrreeeexxxxeeeeccccdddd).  It
  699.           may also be the case that the server is not listed in one or more of
  700.           /etc/hosts, NIS, or DNS, on the client, in which case nnnnssssrrrreeeexxxxeeeeccccdddd
  701.           cannot validate the server until the client's host naming
  702.           configuration is fixed.
  703.  
  704.      /_p_a_t_h////nnnnssssrrrreeeexxxxeeeeccccdddd:::: IIIInnnnvvvvaaaalllliiiidddd aaaauuuutttthhhheeeennnnttttiiiiccccaaaattttoooorrrr
  705.      /_p_a_t_h////nnnnssssrrrreeeexxxxeeeeccccdddd:::: IIIInnnnvvvvaaaalllliiiidddd ccccoooommmmmmmmaaaannnndddd
  706.           These two messages should never occur in a savegroup completion
  707.           message.  They mean that ssssaaaavvvveeeeggggrrrrpppp did not follow its protocol
  708.           correctly.
  709.  
  710.      /_p_a_t_h////nnnnssssrrrreeeexxxxeeeeccccdddd:::: PPPPeeeerrrrmmmmiiiissssssssiiiioooonnnn ddddeeeennnniiiieeeedddd
  711.      PPPPeeeerrrrmmmmiiiissssssssiiiioooonnnn ddddeeeennnniiiieeeedddd
  712.           These similar messages are generated by nnnnssssrrrreeeexxxxeeeeccccdddd and rrrrsssshhhhdddd,
  713.           respectively.  In either case, the server does not have permission
  714.           to execute commands on the client.  In the case of the first
  715.           message, make sure that the server is listed as a valid server on
  716.           the client (see "Host _s_e_r_v_e_r cannot request command execution",
  717.           above, for details).  In the case of the second message, which does
  718.           not mention nnnnssssrrrreeeexxxxeeeeccccdddd, make sure that "_s_e_r_v_e_r_n_a_m_e" is listed in the
  719.           client's /._r_h_o_s_t_s file (or, if you have set the _r_e_m_o_t_e _u_s_e_r
  720.  
  721.  
  722.  
  723.                                                                        PPPPaaaaggggeeee 11111111
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730. SSSSAAAAVVVVEEEEGGGGRRRRPPPP((((1111MMMM))))                                                        SSSSAAAAVVVVEEEEGGGGRRRRPPPP((((1111MMMM))))
  731.  
  732.  
  733.  
  734.           attribute for this client, the ._r_h_o_s_t_s file in the home directory
  735.           for that user on the client).
  736.  
  737.      ////_p_a_t_h////ssssaaaavvvveeeeggggrrrrpppp:::: pppprrrriiiinnnnttttiiiinnnngggg bbbboooooooottttssssttttrrrraaaapppp iiiinnnnffffoooorrrrmmmmaaaattttiiiioooonnnn ffffaaaaiiiilllleeeedddd
  738.           See "unknown printer" below.
  739.  
  740.      rrrreeeeaaaaddddiiiinnnngggg lllloooogggg ffffiiiilllleeee ffffaaaaiiiilllleeeedddd
  741.           After the specified save set completed, savegrp was unable to read
  742.           the log file of the output status from the save set.  This generally
  743.           means that someone, or an automated non-NetWorker administrative
  744.           program or script, removed the log file.  This message can also
  745.           occur if the filesystem on which the client logs are stored has run
  746.           out of space (use ddddffff ////nnnnssssrrrr////ttttmmmmpppp to determine if this is the case).
  747.           Verify that no scripts remove files from /_n_s_r/_t_m_p (which is where
  748.           savegrp stores the save set log files).
  749.  
  750.      rrrreeeeqqqquuuueeeesssstttt ffffrrrroooommmm mmmmaaaacccchhhhiiiinnnneeee _s_e_r_v_e_r rrrreeeejjjjeeeecccctttteeeedddd
  751.           The server is not listed in the PC (NetWare or DOS) client's list of
  752.           acceptable servers.  See your ClientPak installation guide for
  753.           instructions on adding the server to the client-side list.
  754.  
  755.      _N rrrreeeettttrrrriiiieeeessss aaaatttttttteeeemmmmpppptttteeeedddd
  756.      _1 rrrreeeettttrrrryyyy aaaatttttttteeeemmmmpppptttteeeedddd
  757.           One of these informational messages is prepended to a save set's
  758.           output if ssssaaaavvvveeeeggggrrrrpppp was unable to backup the data on the first try and
  759.           if the _c_l_i_e_n_t _r_e_t_r_i_e_s attribute for the group has a value greater
  760.           than zero.  In this case, the specified number of retries was
  761.           performed before the backup of the save set succeeded or was finally
  762.           marked as failed.
  763.  
  764.      RRRRPPPPCCCC eeeerrrrrrrroooorrrr,,,, _d_e_t_a_i_l_s...
  765.      CCCCaaaannnnnnnnooootttt ooooppppeeeennnn ssssaaaavvvveeee sssseeeessssssssiiiioooonnnn wwwwiiiitttthhhh ````_s_e_r_v_e_r''''
  766.           The ssssaaaavvvveeee command generates this message if it is unable to back up
  767.           data to the NetWorker server.  There are several possible _d_e_t_a_i_l_s.
  768.           The most likely causes are:  resources are exceeded on the server so
  769.           nsrd cannot accept new save sessions, nsrd actually died since
  770.           savegrp started (however, this is unlikely, since you cannot
  771.           normally receive a savegrp completion message after nsrd dies, but
  772.           you can see this when using the ----pppp option), there are numerous
  773.           network errors occurring and save cannot open a session to save its
  774.           data (check this by running nnnneeeettttssssttttaaaatttt ----ssss and see how many network
  775.           errors are occurring; you may need to do this several times a few
  776.           minutes apart to get the change in errors).  Save cannot tell which
  777.           of these three causes are the real cause.  If you see these errors
  778.           frequently, and it looks like a server resource problem, you might
  779.           consider increasing the value of the _c_l_i_e_n_t _r_e_t_r_i_e_s attribute of the
  780.           ggggrrrroooouuuupppp resource having these problems.  This won't decrease the
  781.           resource utilization, but will make ssssaaaavvvveeeeggggrrrrpppp more robust so such
  782.           problems (the trade-off is that increasing _c_l_i_e_n_t _r_e_t_r_i_e_s will
  783.           increase the load on the server even more).
  784.  
  785.  
  786.  
  787.  
  788.  
  789.                                                                        PPPPaaaaggggeeee 11112222
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796. SSSSAAAAVVVVEEEEGGGGRRRRPPPP((((1111MMMM))))                                                        SSSSAAAAVVVVEEEEGGGGRRRRPPPP((((1111MMMM))))
  797.  
  798.  
  799.  
  800.      RRRRPPPPCCCC eeeexxxxeeeecccc oooonnnn _c_l_i_e_n_t iiiissss uuuunnnnaaaavvvvaaaaiiiillllaaaabbbblllleeee....  TTTTrrrryyyyiiiinnnngggg RRRRSSSSHHHH....
  801.           This informational message is only displayed when the ----vvvv flag has
  802.           been used for verbose information.  This message means that nnnnssssrrrreeeexxxxeeeeccccdddd
  803.           is not running on the client, and that savegrp is attempting to use
  804.           the rrrrsssshhhhdddd service instead, for backward compatibility with older
  805.           versions of ssssaaaavvvveeeeggggrrrrpppp.
  806.  
  807.      ssssaaaavvvveeee:::: _c_l_i_e_n_t_n_a_m_e_2 iiiissss nnnnooootttt oooonnnn _c_l_i_e_n_t''''ssss aaaacccccccceeeessssssss lllliiiisssstttt
  808.           This error occurs when the named client has more than one name, for
  809.           example, a short name, _c_l_i_e_n_t, and a fully-qualified domain name,
  810.           _c_l_i_e_n_t._l_e_g_a_t_o._c_o_m.  When the client attempts to connect back to the
  811.           NetWorker server to start a save, that client is calling itself by
  812.           the name _c_l_i_e_n_t, which matches the client resource name, but when
  813.           the server looks up the client's network address, it is getting back
  814.           the name _c_l_i_e_n_t_n_a_m_e_2.  If this is, in fact, correct, add the name
  815.           _c_l_i_e_n_t_n_a_m_e_2 to the client's aaaalllliiiiaaaasssseeeessss attribute, and re-run the save.
  816.  
  817.      ssssaaaavvvveeee:::: ppppaaaatttthhhh lllleeeennnnggggtttthhhh ooooffff _x_x_x_x ttttoooooooo lllloooonnnngggg,,,, ddddiiiirrrreeeeccccttttoooorrrryyyy nnnnooootttt ssssaaaavvvveeeedddd
  818.           This message can occur if you have a directory tree that is very
  819.           deep, or directory names that are very long.  This message can also
  820.           occur if there are bad blocks in the specified filesystem, or if the
  821.           filesystem is corrupt.  NetWorker limits the full pathname to 1024
  822.           characters which is the system imposed maximum on most systems.  To
  823.           save such directories, you need to rename or move the directories so
  824.           that the full pathname is shorter than 1024 characters.  If the
  825.           filesystem appears to be corrupted (for example, a very long
  826.           pathname that looks like it has a loop in the name), perform a
  827.           filesystem check on the specified client.
  828.  
  829.      /_p_a_t_h////ssssaaaavvvveeee:::: CCCCoooommmmmmmmaaaannnndddd nnnnooootttt ffffoooouuuunnnndddd
  830.      /_p_a_t_h////ssssaaaavvvveeeeffffssss:::: CCCCoooommmmmmmmaaaannnndddd nnnnooootttt ffffoooouuuunnnndddd
  831.      /_p_a_t_h////ssssaaaavvvveeee:::: NNNNooootttt ffffoooouuuunnnndddd
  832.      /_p_a_t_h////ssssaaaavvvveeeeffffssss:::: NNNNooootttt ffffoooouuuunnnndddd
  833.           The ssssaaaavvvveeee or ssssaaaavvvveeeeffffssss command could not be found in the specified path.
  834.           If you are using nnnnssssrrrreeeexxxxeeeeccccdddd, this probably means that the ssssaaaavvvveeee or
  835.           ssssaaaavvvveeeeffffssss command is not in the same directory in which nnnnssssrrrreeeexxxxeeeeccccdddd is
  836.           installed (or that ssssaaaavvvveeee or ssssaaaavvvveeeeffffssss was removed).  If you are using
  837.           rrrrsssshhhhdddd for remote execution, then you need to set the _e_x_e_c_u_t_a_b_l_e _p_a_t_h
  838.           attribute in the _C_l_i_e_n_t resource for this client to be the directory
  839.           in which the NetWorker executables are installed on the client.
  840.  
  841.      ssssaaaavvvveeeeffffssss:::: eeeerrrrrrrroooorrrr ssssttttaaaarrrrttttiiiinnnngggg ssssaaaavvvveeee ooooffff _f_i_l_e_s_y_s_t_e_m
  842.           This informational message accompanies several other ssssaaaavvvveeee or aaaassssmmmm
  843.           messages listed here.  This message means that savefs has detected
  844.           the failed save and has marked the save set as failed.
  845.  
  846.      ssssaaaavvvveeee:::: uuuunnnnkkkknnnnoooowwwwnnnn hhhhoooosssstttt nnnnaaaammmmeeee:::: _s_e_r_v_e_r
  847.      ssssaaaavvvveeeeffffssss:::: uuuunnnnkkkknnnnoooowwwwnnnn hhhhoooosssstttt nnnnaaaammmmeeee:::: _s_e_r_v_e_r
  848.           The host table on the specified client (either /etc/hosts, NIS or
  849.           DNS, depending on that client's configuration) does not include the
  850.           server's name.  You need to add the server's hostname to the
  851.           specified client's host table.  Note that if you use DNS but the
  852.  
  853.  
  854.  
  855.                                                                        PPPPaaaaggggeeee 11113333
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862. SSSSAAAAVVVVEEEEGGGGRRRRPPPP((((1111MMMM))))                                                        SSSSAAAAVVVVEEEEGGGGRRRRPPPP((((1111MMMM))))
  863.  
  864.  
  865.  
  866.           server's Client resource name (i.e. the client resource for the
  867.           server itself) is not fully qualified (i.e. it looks like "server",
  868.           not "server.dom.ain", and the server is in a different domain from
  869.           the client, you will need to add the name _s_e_r_v_e_r to the domain table
  870.           for the domain containing the client.  If you use NIS, this error
  871.           means that either the NIS hosts map does not contain the server, the
  872.           /_e_t_c/_h_o_s_t_s file does not list the server, or the NIS master for the
  873.           specified client is otherwise mis-configured (the server is a
  874.           secondary server and there is no yyyyppppppppuuuusssshhhh(1M) from the primary; run
  875.           yyyyppppwwwwhhhhiiiicccchhhh ----mmmm on the client to find out which NIS server is providing
  876.           master translation).
  877.      ssssaaaavvvveeeeggggrrrrpppp:::: cccclllliiiieeeennnntttt rrrrccccmmmmdddd((((3333)))) pppprrrroooobbbblllleeeemmmm ffffoooorrrr ccccoooommmmmmmmaaaannnndddd ''''_c_o_m_m_a_n_d''''
  878.           This error message normally accompanies another, more specific,
  879.           error message.  It is generated when the attempt to run the
  880.           specified command (usually ssssaaaavvvveeee or ssssaaaavvvveeeeffffssss with several command line
  881.           parameters) failed on the specified save set.  The previous line of
  882.           error output should include the more specific error message (look
  883.           for that message elsewhere in this section).  Generally, the problem
  884.           is a bad hosttable configuration, or various permissions denied
  885.           errors (server not specified when starting nsrexecd, or missing
  886.           permissions in .rhosts if not using nsrexecd).  If not, log into the
  887.           NetWorker server as root and run the command ssssaaaavvvveeeeggggrrrrpppp ----pppp ----vvvv ----cccc
  888.           _c_l_i_e_n_t_n_a_m_e _g_r_o_u_p_n_a_m_e giving the appropriate client for _c_l_i_e_n_t_n_a_m_e
  889.           and _g_r_o_u_p_n_a_m_e . This verbose output should include the necessary
  890.           additional information needed for fixing the problem.
  891.      SSSSaaaavvvviiiinnnngggg sssseeeerrrrvvvveeeerrrr iiiinnnnddddeeeexxxx bbbbeeeeccccaaaauuuusssseeee sssseeeerrrrvvvveeeerrrr iiiissss nnnnooootttt iiiinnnn aaaannnn aaaaccccttttiiiivvvveeee ggggrrrroooouuuupppp
  892.           This informational message, generated by ssssaaaavvvveeeeggggrrrrpppp, means that savegrp
  893.           has noticed that the NetWorker server is not listed in any
  894.           automatically started, enabled group.  Since all of the indexes are
  895.           stored on the server, ssssaaaavvvveeeeggggrrrrpppp is saving the server's index and
  896.           bootstrap information in case a disaster occurs.  You should add the
  897.           server to a group with autostart enabled, or enable one of the
  898.           groups of which the server is already a member.
  899.      ssssoooocccckkkkeeeetttt:::: AAAAllllllll ppppoooorrrrttttssss iiiinnnn uuuusssseeee
  900.           The NetWorker server has run out of socket descriptors.  This means
  901.           that you have exceeded the socket resource limit on your server.  To
  902.           avoid such future messages, you should determine what other network
  903.           services are running while savegrp is running, and consider re-
  904.           scheduling either savegrp or the other service(s).  You can also
  905.           reduce the parallelism in the nnnnssssrrrr____sssseeeerrrrvvvviiiicccceeee(4) resource, to reduce the
  906.           resource utilization.
  907.      ssssoooocccckkkkeeeetttt:::: pppprrrroooottttooooccccoooollll ffffaaaaiiiilllluuuurrrreeee iiiinnnn cccciiiirrrrccccuuuuiiiitttt sssseeeettttuuuupppp....
  908.           The client does not seem to support the TCP/IP protocol stack, or
  909.           has not used a privileged port for setting up its connection.  The
  910.           latter could occur if you use nnnnssssrrrreeeexxxxeeeeccccdddd but did not start it as root
  911.           on the specified client.  The nnnnssssrrrreeeexxxxeeeeccccdddd daemon must run as root on
  912.           each client.
  913.      _p_a_t_h:::: TTTThhhhiiiissss ddddaaaattttaaaa sssseeeetttt iiiissss iiiinnnn uuuusssseeee aaaannnndddd ccccaaaannnnnnnnooootttt bbbbeeee aaaacccccccceeeesssssssseeeedddd aaaatttt tttthhhhiiiissss ttttiiiimmmmeeee
  914.           This message is generated by save sets on PC clients running DOS or
  915.           NetWare.  The NetWorker client software on these systems cannot back
  916.           up files open for writing, due to the interface provided by the
  917.           operating system.  This message actually comes from Novell's TSA and
  918.  
  919.  
  920.  
  921.                                                                        PPPPaaaaggggeeee 11114444
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928. SSSSAAAAVVVVEEEEGGGGRRRRPPPP((((1111MMMM))))                                                        SSSSAAAAVVVVEEEEGGGGRRRRPPPP((((1111MMMM))))
  929.  
  930.  
  931.  
  932.           is not changeable.
  933.      uuuunnnnkkkknnnnoooowwwwnnnn hhhhoooosssstttt
  934.           The specified client is not listed in the host table on the server
  935.           (note: a similar "save" or "savefs" specific message is described
  936.           above).  Depending on your host configuration, this means the client
  937.           is not listed in one (or more) of /etc/hosts, NIS, or the Domain
  938.           Name Service.  If you use fully qualified domain names, you may need
  939.           to make a new client resource for this client, using that fully
  940.           qualified domain name (i.e. name the client resource
  941.           "mars.legato.com", not "mars").
  942.      _p_r_i_n_t_e_r:::: uuuunnnnkkkknnnnoooowwwwnnnn pppprrrriiiinnnntttteeeerrrr
  943.      _p_a_t_h////ssssaaaavvvveeeeggggrrrrpppp:::: pppprrrriiiinnnnttttiiiinnnngggg bbbboooooooottttssssttttrrrraaaapppp iiiinnnnffffoooorrrrmmmmaaaattttiiiioooonnnn ffffaaaaiiiilllleeeedddd
  944.      ((((rrrreeeepppprrrroooodddduuuucccceeeedddd bbbbeeeelllloooowwww))))
  945.           This message, or similar messages, accompanies the bootstrap
  946.           information when ssssaaaavvvveeeeggggrrrrpppp was unable to print the bootstrap on the
  947.           printer.  You need to either specify a different printer in the
  948.           _p_r_i_n_t_e_r attribute for the group, or configure your print server to
  949.           recognize the printer (by default, your system's default printer is
  950.           used).  The bootstrap information is listed as part of the savegrp
  951.           completion mail.  You should print out this information immediately,
  952.           in case your server has a disaster and loses a disk, and fix the
  953.           printer name used by ssssaaaavvvveeeeggggrrrrpppp.
  954.  
  955.      WWWWaaaarrrrnnnniiiinnnngggg ---- ffffiiiilllleeee ````_p_a_t_h'''' cccchhhhaaaannnnggggeeeedddd dddduuuurrrriiiinnnngggg ssssaaaavvvveeee
  956.           This warning message is generated when ssssaaaavvvveeee notices that the file's
  957.           modification time changed while the file was being backed up.
  958.           NetWorker does not attempt to lock files before saving them, since
  959.           this would make backups run extremely slowly.  You may wish to
  960.           backup files which generate this message manually, to ensure that a
  961.           consistent copy is saved.  NetWorker does not attempt this
  962.           automatically, to avoid trying forever on the same file.
  963.  
  964.      WWWWaaaarrrrnnnniiiinnnngggg:::: ````_c_l_i_e_n_t'''' iiiissss nnnnooootttt iiiinnnn tttthhhheeee hhhhoooossssttttssss ttttaaaabbbblllleeee!!!!
  965.           This message is generated by a ssssaaaavvvveeee or ssssaaaavvvveeeeffffssss command run on the
  966.           specified client to save that client's filesystems.  The client's
  967.           hostname is not listed in the host table on the client (either
  968.           /etc/hosts, NIS or DNS, depending on that client's configuration).
  969.           This almost always results in a failed save.  Fix the client's host
  970.           table and re-run the save.
  971.  
  972.      _a_s_m:::: _p_a_t_h wwwwaaaassss nnnnooootttt ssssuuuucccccccceeeessssssssffffuuuullllllllyyyy ssssaaaavvvveeeedddd
  973.           This message generally accompanies one or more other more-specific
  974.           messages for the save set.  The specified path within the current
  975.           save set was not saved successfully.  The backup will continue
  976.           trying to back up other files and directories on the save set.
  977.  
  978.      _a_s_m:::: xxxxddddrrrr__o_p ffffaaaaiiiilllleeeedddd ffffoooorrrr _p_a_t_h
  979.           This error can be caused by several possible conditions (e.g. out of
  980.           memory, buggy networking software in the operating system, an
  981.           external ASM unexpectedly exiting, a lost network connection).  If
  982.           it was due to a lost network connection, then the NetWorker server
  983.           most likely exited (due to nnnnssssrrrr____sssshhhhuuuuttttddddoooowwwwnnnn).  After restarting the
  984.  
  985.  
  986.  
  987.                                                                        PPPPaaaaggggeeee 11115555
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994. SSSSAAAAVVVVEEEEGGGGRRRRPPPP((((1111MMMM))))                                                        SSSSAAAAVVVVEEEEGGGGRRRRPPPP((((1111MMMM))))
  995.  
  996.  
  997.  
  998.           server, rerun the group.  If due to an ASM exiting unexpectedly (in
  999.           this case, the message should be accompanied by a message describing
  1000.           which ASM exited unexpectedly), you may have found a bad block on
  1001.           the disk, or perhaps a bug.  Check if the client ran out of memory
  1002.           (there may be console messages), and verify that there are no bad
  1003.           blocks on the save set's disk.  If there were network errors, there
  1004.           may also have been messages logged by other programs on the system
  1005.           console (client or server), or to system log files.
  1006.  
  1007. FFFFIIIILLLLEEEESSSS
  1008.      ////nnnnssssrrrr////ttttmmmmpppp////ssssgggg...._g_r_o_u_p           A lock file to keep multiple savegrps of the
  1009.                                  same group from running simultaneously.
  1010.      ////nnnnssssrrrr////ttttmmmmpppp////ssssgggg...._g_r_o_u_p...._c_l_i_e_n_t....****  Temporary files used to log the output of
  1011.                                  individual save sets for the named group and
  1012.                                  client.
  1013.      ////nnnnssssrrrr////ttttmmmmpppp////gggg_g_r_o_u_p****            On filesystems with short names (less than 64
  1014.                                  characters), the temporary files used to log
  1015.                                  the output of individual save sets for the
  1016.                                  named group.
  1017.  
  1018. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  1019.      llllssss(1), ppppssss(1), nnnnssssrrrr____ggggeeeettttddddaaaatttteeee(3), rrrrccccmmmmdddd(3), ffffssssttttaaaabbbb(4), nnnnssssrrrr(4),
  1020.      nnnnssssrrrr____ddddiiiirrrreeeeccccttttiiiivvvveeee(4), nnnnssssrrrr____nnnnoooottttiiiiffffiiiiccccaaaattttiiiioooonnnn(4), nnnnssssrrrr____sssseeeerrrrvvvviiiicccceeee(4), nnnnssssrrrr____ggggrrrroooouuuupppp(4),
  1021.      nnnnssssrrrr____sssscccchhhheeeedddduuuulllleeee(4), nnnnssssrrrr____rrrreeeessssoooouuuurrrrcccceeee(4), mmmmmmmmiiiinnnnffffoooo(1M), nnnneeeettttssssttttaaaatttt(1M), nnnnssssrrrr(1M),
  1022.      nnnnssssrrrraaaaddddmmmmiiiinnnn(1M), nnnnssssrrrreeeexxxxeeeeccccdddd(1M), nnnnssssrrrrwwwwaaaattttcccchhhh(1M), nnnnwwwwaaaaddddmmmmiiiinnnn(1M), rrrrsssshhhhdddd(1M),
  1023.      ssssaaaavvvveeee(1M), ssssaaaavvvveeeeffffssss(1M), yyyyppppppppuuuusssshhhh(1M).
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.                                                                        PPPPaaaaggggeeee 11116666
  1054.  
  1055.  
  1056.  
  1057.